home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbfv33.zip / PCBFV.DOC < prev    next >
Text File  |  1993-01-29  |  95KB  |  1,896 lines

  1.     
  2.  
  3.  
  4.  
  5.  
  6.          ------------------------------------------------------------------
  7.         |                                                                  |
  8.         |                                                                  |
  9.         |                                                                  |
  10.         |                                                                  |
  11.         |                        PCBFV Version 3.3                         |
  12.         |                                                                  |
  13.         |                PCBoard F V Compressed File Viewer                |
  14.         |                                                                  |
  15.         |                               For                                |
  16.         |                                                                  |
  17.         |                  PCBoard Versions 14.5 & 14.5a                   |
  18.         |                                                                  |
  19.         |                            including                             |
  20.         |                                                                  |
  21.         |                      PCBoard /M Multi-Port                       |
  22.         |                                                                  |
  23.         |                                                                  |
  24.         |      *   Seamless Interface - Looks Like Part of PCBoard   *     |
  25.         |                                                                  |
  26.         |                                                                  |
  27.         |                  Allows Text File Reading On-Line                |
  28.         |                                                                  |
  29.         |                                                                  |
  30.         |          Allows Selecting Files For Individual Download          |
  31.         |                                                                  |
  32.         |                                                                  |
  33.         |    Runs In The F V Shell, As A Door, In PCBFiler, and Locally    |
  34.         |                                                                  |
  35.         |                                                                  |
  36.         |                                                                  |
  37.         |                All Options Are Sysop-Configurable                |
  38.         |                                                                  |
  39.         |                                                                  |
  40.         |                                                                  |
  41.         |                        PCBFV Version 3.3                         |
  42.         |                                                                  |
  43.         |       (C) Copyright 1990-1993   Yandell Computer Services        |
  44.         |                                                                  |
  45.         |             12121 Little Road - Bldg. 303 - Suite 212            |
  46.         |                         Hudson, FL 34667                         |
  47.         |                                                                  |
  48.         |                      DATA -- (813) 842-8099                      |
  49.         |                                                                  |
  50.         |                                                                  |
  51.         |                         January 29, 1993                         |
  52.         |                                                                  |
  53.         |                                                                  |
  54.         |                                                                  |
  55.          ------------------------------------------------------------------ 
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.         --------------------------------------------------------------------
  70.                                        PCBFV
  71.         --------------------------------------------------------------------
  72.            
  73.                                   TABLE OF CONTENTS                     
  74.               INTRODUCTION                                              Page
  75.               ------------                                              ----
  76.               1.0  What Is PCBFV                                           3
  77.               1.1  What Is New In Version 3.3                              3
  78.               1.2  Multi-Nodes, Networks, Multi-taskers                    3
  79.               1.3  Documentation Definition - (F) versus (FLAG)            3
  80.    
  81.               INSTALLING PCBFV IN THE F_V SHELL
  82.               ---------------------------------
  83.               2.0  PCBFV's SWAP and Determining Memory Requirements        4
  84.               2.1  Setting Up PCBVIEW.BAT                                  4
  85.               2.2  Multi-Node Systems and PCBFV.CNF                        5
  86.               2.3  Upgrading from Previous Versions to PCBFV 3.3           5
  87.               2.4  Running FVSETUP and Creating PCBFV.CNF               6-11
  88.               2.5  FVHLP Help File (Macros, Color, Etc.)                  12
  89.               2.6  Limiting (F)lag File Types with FLAG.DAT               12
  90.               2.7  PCBFV's Menu (FVMNU)                                   13
  91.               2.8  Managing Caller Created Compressed Files               13
  92.               2.9  Setting up Environment Variables for ZIP 2.0           14
  93.               2.10 Sample Configurations                               15-16
  94.  
  95.               INSTALLING PCBFV IN OTHER AREAS
  96.               -------------------------------
  97.               3.0  Installing PCBFV in PCBFiler                           17
  98.               3.1  Installing PCBFV as a Local Utility                    17
  99.               3.2  Installing PCBFV as a Door                             18
  100.  
  101.               RUN-TIME CONSIDERATIONS
  102.               -----------------------
  103.               4.0  Notes Regarding the (R)ead Command                     19
  104.               4.1  Notes Regarding the (S)elect Command                   20
  105.               4.2  Notes Regarding the (F)lag Command                     20
  106.               4.3  Notes Regarding the AutoFlag Feature                   21
  107.               4.4  Notes Regarding "Flagging Across Files"                22
  108.               4.5  Notes Regarding the (I)nventory Command                22
  109.               4.6  Notes Regarding Compression Utilities                  23
  110.               4.7  Notes Regarding the (D)elete Command                   24
  111.               4.8  Notes Regarding the (Z)ip-Extra Command                24
  112.                          
  113.               MISCELLANEOUS
  114.               ------------- 
  115.               5.0  Sysop Function Keys                                    25
  116.               5.1  Technical Notes                                        25
  117.               5.2  Caller Log Entries                                     26
  118.               5.3  Error Messages                                         26
  119.               5.4  Where to Receive Assistance                            27
  120.               5.5  Disclaimer and Warranty                                27
  121.               5.6  License to use PCBFV                                   27
  122.               5.7  New Compression Utility Releases                       28
  123.               5.8  Revision History                                       28
  124.                
  125.               REGISTRATION       
  126.               ------------
  127.               6.0  Registering PCBFV                                      29
  128.               6.1  Register with CONFIDENCE - Author Information          29
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.         --------------------------------------------------------------------
  136.         Page 3                         PCBFV                          Page 3
  137.         --------------------------------------------------------------------
  138.  
  139.         1.0  What is PCBFV
  140.         ------------------
  141.         PCBFV  is a PCBoard BBS utility primarily for use in the F  V  (File 
  142.         View) shell process.  PCBFV may also be used as the file  viewer  in 
  143.         PCBFiler.  PCBFV may be installed to run as a door.  PCBFV  displays 
  144.         the contents of ZIP, ARJ, LZH, PAK, and  ARC files.  Self-extracting 
  145.         files created by PKZIP, LHA, and ARJ (2.20 and later) are supported. 
  146.         PCBFV will also display the resolution of .GIF files  (width-height- 
  147.         colors).
  148.                               
  149.         PCBFV will optionally allow a  caller to (R)ead text files contained 
  150.         within  a compressed file, and search for text within  those  files. 
  151.         The Sysop may allow the caller to read non-text files in a HEX  mode  
  152.         display.  PCBFV  will  also optionally allow a caller  to  (F)lag  a 
  153.         compressed  file's members for individual downloading.  Uncompressed 
  154.         files in a download path  may  be read by PCBFV.  The Sysop has full 
  155.         control over which  features of PCBFV  are enabled  on their system.  
  156.         The  goal  in PCBFV's  development has been to   make  the  caller's 
  157.         interface to the F V process appear as "seamless" as possible. Great 
  158.         emphasis has been placed on making the appearance of PCBFV appear as 
  159.         similar as possible to PCBoard.  
  160.  
  161.         1.1  What is new in version 3.3
  162.         -------------------------------
  163.         Please read the enclosed FEATURES.NEW file for details.
  164.  
  165.         1.2  Multi-nodes, networks, multi-taskers
  166.         -----------------------------------------
  167.         PCBFV has been developed in a networked environment.  All multi-node 
  168.         features are thoroughly tested on our own multi-node PCBoard system. 
  169.         Two of PCBFV's primary beta test facilities are twenty node systems.
  170.         The  largest  known installation of PCBFV is on a  225  node  system 
  171.         (which is also a beta test site).
  172.         
  173.         PCBFV is DESQview aware.  It is automatically detected,  screen  and 
  174.         keyboard  I/O are "well behaved", and time slices are given back  to 
  175.         other applications while PCBFV is idle at an input prompt.
  176.                     
  177.         DESQview is the only multi-tasking software supported by PCBFV. 
  178.  
  179.         Pertinent  multi-node  information is highlighted with  *MULTI-NODE* 
  180.         throughout this document.
  181.  
  182.         1.3  Documentation definition - (F) versus (FLAG)   
  183.         -------------------------------------------------
  184.         If "FL", "FLA" or "FLAG" are entered at the PCBFV prompt, the entire 
  185.         compressed  file  being viewed will be entered into  PCBoard's  FLAG 
  186.         queue upon return to PCBoard (14.5a). An "F" alone is for extraction  
  187.         of  individual  files  for downloading.  Since  the  "FLAG"  command 
  188.         requires  no setup or configuration, all references to (F)lag, Flag, 
  189.         Flagging,  etc.  in  this documentation are references  to  the  "F" 
  190.         individual file extraction command process.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.         --------------------------------------------------------------------
  202.         Page 4                         PCBFV                          Page 4
  203.         --------------------------------------------------------------------
  204.  
  205.         2.0  PCBFV's SWAP and determining memory requirements
  206.         -----------------------------------------------------
  207.         PCBFV can swap itself to EMS or disk (disk if EMS is not  available)  
  208.         if  there is insufficient memory to call upon  external  compression 
  209.         utilities.  "Swapping" must be turned on using FVSETUP.EXE.  Use the
  210.         table below to determine if you need to turn swapping on.
  211.                                                                       
  212.         The memory amounts below are what must be showing on PCBFV's  status 
  213.         line in order for the corresponding compression type to function.
  214.                                                                       
  215.         This column shows the minimum        This column shows the minimum
  216.         memory needed for (R)eading          memory needed for creating a 
  217.         FROM the compressed file type.       caller's Flag file.
  218.           PCBFV'S  PCBFV'S                     PCBFV'S  PCBFV'S      
  219.           SWAP ON  SWAP OFF                    SWAP ON  SWAP OFF
  220.             15K      115K        <  ZIP  >       95K      195K        
  221.             10K      105K        <  ARC  >       40K      140K        
  222.             55K      155K        <  LZH  >       100K     200K        
  223.             85K      185K        <  PAK  >       85K      185K        
  224.             90K      190K        <  ARJ  >       150K     250K        
  225.                                                                       
  226.         NOTES:
  227.         * If you are running PCBoard in /SWAP mode, it is very unlikely that
  228.         PCBFV itself would ever need to swap.
  229.                
  230.         * If PCBFV swaps and EMS is not available, a disk file is created in 
  231.         the PCBFV work area called FVSWPxxx.$$$ (xxx = node number).
  232.  
  233.         2.1  Setting up PCBVIEW.BAT
  234.         ---------------------------
  235.         The  first  line of your PCBVIEW.BAT  file(s) should be ECHO OFF  or 
  236.         @ECHO  OFF,   depending on the version of DOS you  are  using.  Load 
  237.         PCBVIEW.BAT into a text editor. The syntax for calling PCBFV is out-
  238.         lined in figure 2.1 below.
  239.  
  240.         NOTE:  Never change drives or CD\ in PCBVIEW.BAT. ALWAYS call  PCBFV 
  241.         with its location in-line as shown below.
  242.  
  243.          ------------------------------------------------------------------
  244.         | M:\PCBFV\PCBFV.EXE  PCBFV.CNF  %1                                |
  245.         | ------------------  ---------  --                                |
  246.         |         |           |          |-> PCBoard will replace this with|
  247.         |         |           |              the compressed file's name.   |
  248.         |         |           |                                            |
  249.         |         |            ---------> The name of the configuration    |
  250.         |         |                       file. Enter a file NAME only.    |
  251.         |         |                       NEVER place a location with name.|
  252.         |         |                       *MULTI-NODE* see section 2.2 for |
  253.         |         |                       more information.                |
  254.         |         |                                                        |
  255.         |          -------> The executable file name.  You MUST place its  |
  256.         |                   location in-line as shown above if you are not |  
  257.         |                   putting PCBFV.EXE in each node's \PCB root.    |
  258.          ------------------------------------------------------------------
  259.                                 ---- Figure 2.1 ----
  260.                             
  261.  
  262.  
  263.                                                                       
  264.  
  265.  
  266.  
  267.         --------------------------------------------------------------------
  268.         Page 5                         PCBFV                          Page 5
  269.         --------------------------------------------------------------------
  270.  
  271.         2.2  Multi-Node systems and PCBFV.CNF                  
  272.         -------------------------------------                  
  273.         To  use a single PCBFV.CNF (providing you are using  one  PCBFV.EXE) 
  274.         for  all nodes,  simply use the @NODE@ macro in two of  the  FVSETUP 
  275.         parameters.  These  are  "work  location  of  extracted  file"   and 
  276.         "Loc\name of new (F)lagged file". Otherwise, you will have to create 
  277.         a  separate  .CNF file for each node and feed PCBFV  the  individual 
  278.         node's  .CNF file in each node's PCBVIEW.BAT.  Refer to the  "sample 
  279.         configurations  section" (section 2.10 page 15) and the  section  on
  280.         "Running FVSETUP and Creating PCBFV.CNF" section 2.4 page 6 thru 11.
  281.  
  282.  
  283.         2.3  Upgrading from previous versions to PCBFV 3.3
  284.         --------------------------------------------------
  285.  
  286.         *** Upgrading to 3.3 from 3.0 through 3.2 ***
  287.         ---------------------------------------------
  288.         REVIEW FEATURES.NEW. The enclosed FVHLP and FVMNU files include new
  289.         commands since versions 3.0 and 3.1.
  290.           
  291.           
  292.         *** Upgrading to 3.3 from 2.0 through 2.5 ***
  293.         ---------------------------------------------
  294.         Use the new FVMNU (menu) and FVHLP (help) files, or rename your  old 
  295.         files  to these new names.  Refer to FEATURES.NEW for more  details. 
  296.         Be  sure to add the new commands if you are renaming your old  FVMNU 
  297.         and FVHLP files to use with PCBFV 3.3.
  298.  
  299.         Refer  to the enclosed FEATURES.NEW file for new features which  you 
  300.         may wish to take advantage of. 
  301.  
  302.         Set  all  parameters in FVSETUP with a blinking asterisk  (*).  This 
  303.         indicates that the parameter has not been set in your PCBFV.CNF. The
  304.         FVSETUP  program will place these asterisks at all parameters  which 
  305.         are not set in PCBFV.CNF files from version 2.0 through version 2.5.
  306.                
  307.         Create any multi-language FVMNU and FVHLP files you wish to use.
  308.  
  309.         If  you are using PCBFV in PCBFILER or as a LOCAL UTILITY:  If  your 
  310.         PCBFV.CNF  contains @NODE@ in the "work location of extracted  file" 
  311.         parameter,  you will have to create a new .CNF file  (FILER.CNF  for 
  312.         instance) for these uses.  The parameters which contained the @NODE@ 
  313.         macros now need to be fully specified in the special FILER.CNF file, 
  314.         and PCBFV.CNF will need to be replaced by FILER.CNF in PCBFILER  and  
  315.         any LOCAL UTILITY batch files.
  316.           
  317.  
  318.         **** Upgrading to 3.3 from 1.1 and earlier ***
  319.         ----------------------------------------------
  320.         If  you  are upgrading from version 1.0 or 1.1 you  must  completely 
  321.         install  a new PCBFV configuration.  PCBFV has simply progressed too
  322.         far  and experienced too many enhancements to attempt to upgrade  it 
  323.         from  these  earlier versions. The enclosed FVSETUP.EXE now  has  F1 
  324.         help  at  each configuration parameter, which should enable  you  to 
  325.         install PCBFV version 3.3 in a matter of minutes.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.         --------------------------------------------------------------------
  334.         Page 6                         PCBFV                          Page 6
  335.         --------------------------------------------------------------------
  336.  
  337.         2.4  Running FVSETUP and creating PCBFV.CNF
  338.         -------------------------------------------
  339.         Enclosed with  PCBFV 3.3 is a file  called  FVSETUP.EXE.  This  file
  340.         allows you to easily and quickly configure your PCBFV  configuration 
  341.         files. If you run a single node system simply use the PCBFV.CNF file
  342.         which came with PCBFV and modify it using FVSETUP to your needs.  If 
  343.         you run a *MULTI-NODE* installation, you will need to decide if  you 
  344.         are going to use a different .CNF file for each  node or if you  are 
  345.         going to use one .CNF file with @NODE@ macros.
  346.                                                                       
  347.         To  start  FVSETUP.EXE, enter  FVSETUP PCBFV.CNF  at your DOS prompt 
  348.         (PCBFV.CNF would be the appropriate node's .CNF file).   
  349.  
  350.         Each parameter in FVSETUP is described on the following pages.
  351.           
  352.         * Idle keyboard time-out (minutes) (and why there is one in PCBFV)
  353.         ------------------------------------------------------------------
  354.         Allows the Sysop to set a keyboard time-out independent of  PCBoard. 
  355.         If a caller has abandoned their terminal, a time-out  will occur  in 
  356.         PCBFV and return them to PCBoard.  PCBoard's timer will then  start.
  357.         If you have a large time-out set in PCBoard, it might be a good idea 
  358.         to set a lower one in PCBFV. If the caller is not coming back to the 
  359.         terminal,  they will have the combined PCBFV and  PCBoard  time-outs 
  360.         occur before PCBoard drops them.
  361.                                         
  362.         * Maximum extracted file size
  363.         -----------------------------
  364.         The maximum uncompressed file size allowed to be extracted for  BOTH 
  365.         (R)ead  & (F)lag commands. If the file selected inside a  compressed 
  366.         file's size is larger than what you specify, it cannot be (R)ead NOR 
  367.         (F)lagged  for download. You may enter 0 for no limit, however  this 
  368.         is not recommended if a RAM drive is used for the `work location  of 
  369.         extracted  file'  parameter (below). This setting  is  ignored  when 
  370.         PCBFV  is running in any local mode, or when the Sysop (the name  in 
  371.         record #1 of your USERS file) is on remotely.
  372.                                            
  373.         * Work location of extracted file
  374.         ---------------------------------
  375.         A "work" location of extracted files for both the (R)ead  and (F)lag 
  376.         commands.  Whenever a caller (R)eads or (F)lags a file, that file is 
  377.         extracted to the location you specify here. If you have a lot of RAM 
  378.         drive space, it is the ideal place for this parameter.  In a *MULTI-
  379.         NODE* environment, you MUST specify a different "work" directory for 
  380.         each  node  and  indicate  that  node's  directory here.  If you are
  381.         *MULTI-NODE*  and are using the single PCBFV.CNF method,  place  the 
  382.         @NODE@ macro in-line here (C:\WORK@NODE@\). PCBFV never deletes work
  383.         directories. It simply insures the appropriate work directory exists
  384.         each  time it is run, and creates it if not.  If you nest your  work 
  385.         subdirectories,  PCBFV will only try to create the "last"  directory 
  386.         in the nest. For example, if your work location is C:\PCB\PCBFV\WORK
  387.         then PCBFV will only attempt to create \WORK. IF C:\PCB\PCBFV didn't 
  388.         exist, PCBFV  will report it couldn't make the  work  directory.  In 
  389.         these cases, you will need to create the work locations manually.
  390.  
  391.                        Section 2.4 continues on the next page
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.         --------------------------------------------------------------------
  400.         Page 7                         PCBFV                          Page 7
  401.         --------------------------------------------------------------------
  402.  
  403.         2.4  Running FVSETUP and creating PCBFV.CNF (continued)
  404.         -------------------------------------------------------
  405.  
  406.         * Path to compression utilities
  407.         -------------------------------
  408.         Enter  ONLY the path of your compression utilities. Do NOT  enter  a 
  409.         file  name  in this parameter.  This parameter allows  PCBFV  to  go 
  410.         directly to your compression utilities, rather than search your path 
  411.         for  them.  This results in  faster  overall  extraction/compression 
  412.         response  time.  DO NOT ENTER A FILE NAME in this  parameter.  PCBFV 
  413.         will expect to find the following compression utilities: 
  414.  
  415.         See section 4.6 on page 23 for required compression utilities.
  416.  
  417.         * Swap PCBFV if needed
  418.         ----------------------
  419.         PCBFV can swap itself to EMS or disk (disk if EMS is not  available)
  420.         if there is not enough memory available to perform (R)ead or  (F)lag
  421.         functions. These are general guidelines for this setting:
  422.           
  423.         Answer  (N)o to never SWAP, (Y)es to automatically determine if  EMS 
  424.         is available and SWAP to it if so or SWAP to disk if not,  or (D)isk 
  425.         to force PCBFV to SWAP to disk even if EMS is available.
  426.                                         
  427.         (1) If you are running PCBoard in /SWAP mode, PCBFV will most likely
  428.         always have enough memory for (R)ead and (F)lag operations.
  429.                
  430.         (2) If this setting is answered Yes, PCBFV will only swap if needed.
  431.         This usually occurs in extremely limited memory situations and/or if
  432.         PCBoard  is not running in the /SWAP mode, and/or when LZH, PAK,  or 
  433.         ARJ files are being (R)ead or (F)lagged from.
  434.  
  435.         (3)  Never answer Yes to this setting if using a multi-tasker  other
  436.         than those listed as being supported in section 1.2 on page 3.
  437.  
  438.         * Follow eXpert mode in USERS
  439.         -----------------------------
  440.         Answering NO will force PCBFV to always display FVMNU unless  it  is
  441.         turned off with the PCBFV X command.  Answering YES will force PCBFV 
  442.         to follow the caller's mode as it was last set in the USERS file.
  443.  
  444.         * Disable (R)ead text option
  445.         ----------------------------
  446.         Allows  the  Sysop to disable the (R)ead text function of PCBFV.  If 
  447.         disabled, the (R) command should be removed from FVHLP and FVMNU.
  448.  
  449.         * Security needed to (R)ead files
  450.         ---------------------------------
  451.         Enter  the minimum security level needed for a caller to be able  to 
  452.         read  text  in a compressed file.  Sysops may want to  prohibit  new 
  453.         callers, non-subscribing callers, etc. from using this feature. 
  454.  
  455.  
  456.                        Section 2.4 continues on the next page
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.         --------------------------------------------------------------------
  466.         Page 8                         PCBFV                          Page 8
  467.         --------------------------------------------------------------------
  468.  
  469.         2.4  Running FVSETUP and creating PCBFV.CNF (continued)
  470.         -------------------------------------------------------
  471.  
  472.         * Maximum lines to read per file
  473.         --------------------------------
  474.         Enter 0 for no limit, or a limit up 9999. This will limit the number 
  475.         of  lines  in EACH text file a caller can read.  Some  Sysops  would 
  476.         rather caller's not read entire text files on-line.  Less scrupulous 
  477.         callers might use the (R)ead function to screen cap text  files  and 
  478.         avoid  file  or byte download ratios which may be  in  effect.  When 
  479.         setting  this,  remember  that  some authors  don't  get  around  to 
  480.         describing  what their software does until 10 or 20 pages  (screens) 
  481.         into the documentation. Between 400 and 500 is a good MINIMUM limit.
  482.         This limitation does not apply to non-text files being displayed  in 
  483.         HEX  mode  (if allowed - see section 2.4 page 11).  This setting  is
  484.         ignored  when PCBFV is running in any local mode, or when the  Sysop 
  485.         (the name in record #1 of your USERS file) is on remotely.
  486.  
  487.         * Default wildcard (R)ead answer
  488.         --------------------------------
  489.         This  parameter  allows you to set what the default answer  will  be 
  490.         when the caller is requesting files to (R)ead.
  491.  
  492.         To present the regular (R)ead input prompt without a default answer, 
  493.         leave this field BLANK, or enter NONE.  
  494.  
  495.         To present a default answer at the read input prompt, such as  *.DOC
  496.         enter *.DOC in this parameter.  This will display:
  497.  
  498.         File within PCBFV.ZIP to read,(L)ist,(wildcards are OK)? (*.DOC    )
  499.  
  500.         You  MUST include a wildcard (* or ?) if enabling a default  answer. 
  501.         Any  caller input other than (Enter) will cause PCBFV to  erase  the 
  502.         default and allow the caller to enter their own input.
  503.  
  504.         * Y/N/A prompt for wildcard find
  505.         --------------------------------
  506.         You  may specify PART of the Yes/No/Abort prompt which  appears  for 
  507.         each filename that matches a wildcard (R)ead request.
  508.  
  509.         Because so many different suggestions have been received as to  what 
  510.         this  prompt  should  be,  it was decided to  allow  each  Sysop  to 
  511.         configure  it to their needs. Note: the (Y) added to the end of  the 
  512.         prompt will always appear, since Yes is the default answer.
  513.          
  514.         (Next: PCBFV.DOC Size: 37793) (H)elp, Read this file? (Y)
  515.                                       |_____________________|
  516.                                                 |
  517.         What you place in this parameter will be inserted here.
  518.         Suggestions: 
  519.         (H)elp, Read this file? 
  520.         (H)elp, Read this file (Yes,No,Abort)? 
  521.         (H)elp, Read this file (Enter)=Yes? 
  522.  
  523.                        Section 2.4 continues on the next page
  524.    
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.         --------------------------------------------------------------------
  532.         Page 9                         PCBFV                          Page 9
  533.         --------------------------------------------------------------------
  534.  
  535.         2.4  Running FVSETUP and creating PCBFV.CNF (continued)
  536.         -------------------------------------------------------
  537.  
  538.         * Disable (S)elect file option
  539.         ------------------------------
  540.         Allows  the  Sysop to disable the "(S)elect another compressed file"
  541.         option.  You  may allow the caller the ability to   select   another 
  542.         compressed  file  for  viewing without  exiting the  F V  shell  (or 
  543.         without returning from PCBFV if used as a door).  (S)elect  improves 
  544.         the  caller interface to the file view process, since the caller  is 
  545.         not returned back and forth to PCBoard if they have several files to 
  546.         view. 
  547.  
  548.         The (S)elect command uses PCBoard conference DLPATH.LST files.
  549.  
  550.         The  (S)elect command uses PCBoard's FSEC to determine if  a  caller 
  551.         has security to view a file. PCBFV will also ask the caller for  the 
  552.         password if a file is password protected in FSEC.
  553.                               
  554.         The details of this function are explained in detail in section  4.1 
  555.         on page 20 of this document.
  556.  
  557.         This  feature may not be available on some PCBoard /D and /S  single 
  558.         node systems running PCBoard 14.5 if SHARE is loaded  (see  page  25
  559.         section 5.1).
  560.  
  561.  
  562.         * # files in each (F)lagged file
  563.         --------------------------------
  564.         Allows  the Sysop to specify the number of files (1-99) that can  be 
  565.         added  to  the file which contains each individually  flagged  file. 
  566.         Entering  0  (zero)  disables  the (F)lag  function.  If  (F)lag  is 
  567.         disabled, the (F) and (I) commands should be removed from FVHLP  and
  568.         FVMNU.
  569.  
  570.  
  571.         * Security needed to (F)lag files
  572.         ---------------------------------
  573.         Enter  the minimum security level needed for a caller to be able  to 
  574.         (F)lag  separate  files  within compressed  files  for  downloading. 
  575.         Sysops  may want to prohibit new callers,  non-subscribing  callers, 
  576.         etc. from using this feature. 
  577.                                                                         
  578.         This  feature may not be available on some PCBoard /D and /S  single 
  579.         node systems running PCBoard 14.5 if SHARE is loaded  (see  page  25
  580.         section 5.1).
  581.    
  582.  
  583.  
  584.  
  585.                        Section 2.4 continues on the next page
  586.    
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.         --------------------------------------------------------------------
  598.         Page 10                        PCBFV                         Page 10
  599.         --------------------------------------------------------------------
  600.  
  601.         2.4  Running FVSETUP and creating PCBFV.CNF (continued)
  602.         -------------------------------------------------------
  603.  
  604.         * Loc\Name of new (F)lagged file 
  605.         --------------------------------
  606.         If (F)lag is allowed, enter the location AND name of the  file which 
  607.         will  be  created and will contain the individual files  the  caller 
  608.         selects for downloading. The location MUST be a drive and path which 
  609.         are listed in your DLPATH.LST!!! The .EXT you place on the  filename 
  610.         determines the compression method used by PCBFV to create the  file. 
  611.         In a *MULTI-NODE* environment, the file NAME in the above  parameter 
  612.         MUST be  different for each of your nodes.  You may accomplish  this 
  613.         by  either placing a different name in each node's .CNF file, or  if 
  614.         you are using a single PCBFV.CNF then place the @NODE@ macro in-line
  615.         here  (C:\UPLOAD\FLAG-@NODE@.ZIP).
  616.             
  617.         IMPORTANT:  The  location you specify should be in  DLPATH.LST,  and 
  618.         should NOT be located in a PCBoard 14.5a INDEX file.
  619.           
  620.         If the (F)lag option is disabled, this entry may be blanked out.
  621.  
  622.  
  623.         * Disable (F)lagging across files 
  624.         ---------------------------------
  625.         Callers  may  flag  files from different  compressed  files  without 
  626.         having  to download the flagged file after each file view.  You  may 
  627.         disable  this  feature.  This feature is explained  in   detail   in 
  628.         section 4.4 on page 22 of this document.
  629.  
  630.  
  631.         * Disable AutoFlag on PCB return
  632.         --------------------------------
  633.         When  PCBFV  terminates  the  F V session  and  returns  control  to 
  634.         PCBoard, it will prompt PCBoard to place the caller created  flagged 
  635.         file  into  PCBoard's  own  FLAG list (if  the  caller  has  flagged 
  636.         separate files in PCBFV).  This parameter allows you to disable this 
  637.         feature. Refer to section 4.3 on page 21 for details on "AutoFlag".
  638.  
  639.  
  640.         * Your PCBFV registration number 
  641.         --------------------------------
  642.         This  is the registration number received when PCBFV is  registered. 
  643.         All   functions  are  enabled  in  unregistered  copies.  The   only 
  644.         limitation is that while reading files, remote callers will not have
  645.         access to  the (F)ind command.  (F)ind may be used  in  unregistered 
  646.         copies  by the Sysop from remote as well as in all local  modes  for 
  647.         evaluation purposes.
  648.           
  649.         Registration also removes the PCBFV [UNREGISTERED COPY] message  and
  650.         brief delay at program termination.  This is not replaced with  your
  651.         system's  name or any other text.  This provides a  true,  seamless, 
  652.         "looks like PCBoard" process.  See the ORDER.FRM file for details.
  653.  
  654.  
  655.                        Section 2.4 continues on the next page
  656.  
  657.  
  658.  
  659.    
  660.  
  661.  
  662.  
  663.         --------------------------------------------------------------------
  664.         Page 11                        PCBFV                         Page 11
  665.         --------------------------------------------------------------------
  666.  
  667.         2.4  Running FVSETUP and creating PCBFV.CNF (continued)
  668.         -------------------------------------------------------
  669.  
  670.         * Non-Text file type for HEX mode
  671.         ---------------------------------
  672.         PCBFV has the ability for callers to read Non-Text  files located in  
  673.         compressed  files, if the Sysop chooses. There are different methods 
  674.         in how this may be implemented:
  675.                          
  676.         (N)one, never display Non-Text files.  Selecting this mode disallows 
  677.         Non-Text  files from ever being displayed. This is like turning  the 
  678.         HEX display mode off completely. Callers will receive a "cannot read 
  679.         non-text file" message if they try to read a non-text file.
  680.  
  681.         (E)xclude executable and compressed files.  Any file with a filename
  682.         extension  of EXE, COM, ZIP, GIF, LZH, PAK, ARC, and ZOO  cannot  be 
  683.         read  by the caller.  Any other file names will be displayed to  the 
  684.         caller  in a HEX display mode if PCBFV determines the file is not  a 
  685.         text file.
  686.                               
  687.         (A)ll, any non-text file will be displayed to the caller in HEX mode 
  688.         if PCBFV determines the file is not a text file. 
  689.  
  690.         The  (E)xclude  mode is probably the best.  This gives  callers  the 
  691.         ability to view things like dBase, Lotus, and other data files while
  692.         preventing  them  from looking at executables  and  "zips  in  zips" 
  693.         in HEX mode. 
  694.  
  695.         Since PCBFV allows reading of files in a download path, this setting 
  696.         will  also  determine  how  non-text files  in  download  paths  are 
  697.         handled regarding the non-text HEX mode display.
  698.  
  699.  
  700.         * Main prompt
  701.         -------------
  702.         You may change PCBFV's main command prompt.  If your PCBoard prompts 
  703.         are  significantly  changed, PCBFV actually won't  live  up  to  its 
  704.         "looks  like  part of PCBoard" claim unless this prompt  is  changed 
  705.         also. The default "(H)elp, File View Command?" is supplied.  You may 
  706.         want to to insert the command letters or command abbreviations:
  707.  
  708.         (H)elp, L, R, S, F, FLAG, I, C, B, X, Z, P, View Command?
  709.  
  710.         Valid  PCBFV commands are (H)elp, (L)ist, (R)ead, (S)elect,  (F)lag,  
  711.         (I)nventory,  (C)RC, (B)rief, (Z)ip-extra, (X)pert, (P)rogram  info, 
  712.         and FLAG.
  713.  
  714.         It  is recommended you at least stay with the PCBoard convention  of 
  715.         beginning the prompt with (H)elp. Don't include any command  letters 
  716.         if they are disabled in your configuration of PCBFV.
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.         --------------------------------------------------------------------
  730.         Page 12                        PCBFV                         Page 12
  731.         --------------------------------------------------------------------
  732.          
  733.         2.5  FVHLP help file (macros, color, etc.)
  734.         ------------------------------------------
  735.         FVHLP  is  a very important part of PCBFV.  It is very  likely  that 
  736.         every  caller  will want (H)elp, at least the first  time  they  use 
  737.         PCBFV.  There are four very important @macros@ used by FVHLP. 
  738.  
  739.         @FILENAME@ - Whenever this appears in FVHLP,  PCBFV will  replace  it
  740.         with the file name which is currently being viewed.
  741.          
  742.         @FILENAMEPD@ - Same as @FILENAME@ except padded to twelve spaces. 
  743.  
  744.         @FLAGFILE@ - Whenever this appears in FVHLP,  PCBFV will  replace it
  745.         with  the name of the compressed file which will be created  when  a
  746.         caller Flags files for separate download. This feature is especially
  747.         helpful for *MULTI-NODE* systems, since a different compressed  file
  748.         name is mandatory for each node. @FLAGFILE@ will be replaced by that 
  749.         node's  file  name as it appears in that node's .CNF  file,  thereby 
  750.         creating the need for only one help file.
  751.  
  752.         @FLAGFILEPD@ - Same as @FLAGFILE@ except padded to twelve spaces.
  753.  
  754.         Color  is used in FVHLP by utilizing the same color macros  used in
  755.         PCBoard 14.5.  ANSI capabilities have been intentionally omitted.
  756.                                     
  757.         Review FVHLP and remove any commands which are not enabled.
  758.           
  759.         FVHLP must reside in the same location with PCBFV.EXE.
  760.  
  761.  
  762.         2.6  Limiting (F)lag file types with FLAG.DAT
  763.         ---------------------------------------------
  764.         You  may limit (F)lagging activity to certain types of  files.  With 
  765.         a  text editor, create a file called FLAG.DAT in the  same  location 
  766.         with  PCBFV.EXE.  Simply begin entering COMPLETE  or  WILDCARD  file 
  767.         names of those files which you wish the caller to be able  to  flag. 
  768.         Press enter (RETURN) after each name so that each entry is on a  new  
  769.         line.  If FLAG.DAT is not present, no limitations are placed on Flag 
  770.         names. See figure 2.6 below for examples of names in FLAG.DAT.
  771.  
  772.          ------------------------------------------------------------------
  773.         | Good examples                                      Bad examples  |
  774.         | -------------                                      ------------  |
  775.         | *.DOC               PCBFV uses regular DOS             .DOC      |
  776.         | *.TXT               wildcard specs to see if           .TXT      |
  777.         | READ*.*             a file is a match. If so,          READ      |
  778.         | *.NEW               the file may be flagged.           .NEW      |
  779.         | FILE.CFG                                               FILE*     |
  780.          ------------------------------------------------------------------
  781.                                 ---- Figure 2.6 ----
  782.  
  783.         If a caller attempts to flag a file which is not allowed, they  will 
  784.         be shown the types of file names which can be flagged.
  785.           
  786.         FLAG.DAT must reside in the same location with PCBFV.EXE
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.         --------------------------------------------------------------------
  796.         Page 13                        PCBFV                         Page 13
  797.         --------------------------------------------------------------------
  798.  
  799.         2.7  PCBFV's menu (FVMNU)
  800.         -------------------------
  801.         The Sysop may create a "menu" which will be displayed before PCBFV's 
  802.         command  prompt each time the prompt is displayed.  This should be a 
  803.         simple text file called "FVMNU" and may contain PCBoard style  color 
  804.         macros  and PCBFV's four custom macros (see FVHLP).  This file  must
  805.         reside in the same location with PCBFV.EXE.  If this file  does  not
  806.         exist,  PCBFV simply shows its main prompt.  PCBFV's main prompt may
  807.         be customized if the Sysop does not wish to use a menu.
  808.                                                             
  809.         2.8  Managing caller created compressed files
  810.         ---------------------------------------------
  811.         Each   time   PCBFV  runs it checks for the  presence  of  a  caller 
  812.         created flagged file. If the file exists and the Sysop has  DISABLED 
  813.         the "Flag across files" function, the file will be deleted. If "Flag 
  814.         across  files"  is allowed, an information file (created  by  PCBFV, 
  815.         explained in detail in section 4.5 page 22) is checked to see if the
  816.         same  caller executing the view is the same caller who  created  the 
  817.         current flagged file. If so, the flagged file is kept for additional 
  818.         flagging, if not, the caller created flagged file is deleted.
  819.  
  820.         **** Deleting FLAGGED files when a caller logs off (PCBoard 14.5a):
  821.         Create or modify $$LOGOFF.BAT in a path available to all nodes or in 
  822.         each node's root to include:
  823.         if exist d:\down\flagged.zip del d:\down\flagged.zip  
  824.  
  825.         Replace  d:\down\flagged.zip  with the appropriate  information  for 
  826.         each node.
  827.           
  828.         ****Deleting FLAGGED files when a caller logs off (PCBoard 14.5):
  829.         Set  PCBoard  to "Exit to DOS after each call".  This is  done  with 
  830.         PCBSETUP,  selection  F  (Options 1) from the  PCBSETUP  main  menu. 
  831.         Answer  Yes  to the "Exit to DOS after each  call"  setting.  Modify 
  832.         BOARD.BAT as indicated below:
  833.         @echo off
  834.         if exist remote.bat rename remote.bat remote.sys
  835.         if exist event.bat rename event.bat event.sys
  836.         if exist door.bat del door.bat
  837.         if exist endpcb del endpcb
  838.         PCB145
  839.         if exist remote.bat remote
  840.         if exist door.bat door
  841.         if exist event.bat event
  842.         if errorlevel == 5 goto cycle                         < INSERT HERE
  843.         if exist endpcb goto end
  844.         :cycle                                                < INSERT HERE
  845.         if exist d:\down\flagged.zip del d:\down\flagged.zip  < INSERT HERE
  846.         board
  847.         :end
  848.         cls
  849.  
  850.         Replace  d:\down\flagged.zip with the appropriate location and  name 
  851.         of the flagged file for the node whose BOARD.BAT is being modified.
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.         --------------------------------------------------------------------
  862.         Page 14                        PCBFV                         Page 14
  863.         --------------------------------------------------------------------
  864.  
  865.         2.9  Setting up environment variables for ZIP 2.0
  866.         -------------------------------------------------
  867.         PKZIP 2.0 performs several auto-sensing functions. These include the
  868.         detection and use of EMS, XMS, 386, Novell, DPMI, and more. If it is
  869.         necessary  for you to disable use of these auto-sensed  modes  while 
  870.         using  these utilities with PCBFV, it may be done using  ENVIRONMENT 
  871.         VARIABLES.  These unique PCBFV environment variables should only  be 
  872.         used  if  these auto-sensing functions need to be turned  off  while 
  873.         being  used  by PCBFV.  If these auto-sensing functions  are  turned 
  874.         off  permanently using prescribed methods in the ZIP  manual,  these 
  875.         PCBFV variables will not be needed.
  876.  
  877.         You  may  set the command line equivalents in  the  following  PCBFV 
  878.         environment variables. These variables are added to the command line 
  879.         PCBFV  creates  when calling the ZIP utilities for  the  (R)ead  and 
  880.         (F)lag functions.
  881.  
  882.         Variable    Affects       Command   Allowable switches
  883.         --------------------------------------------------------------------
  884.         FVUNZIP     PKUNZIP.EXE   (R)ead    -+   (No EMS use)
  885.                                             --   (No XMS use)
  886.                                             -3   (No 386 instructions)
  887.                                             -)   (No DPMI)
  888.  
  889.         FVZIP       PKZIP.EXE     (F)lag    -+   (No EMS use)
  890.                                             --   (No XMS use)
  891.                                             -3   (No 386 instructions)
  892.                                             -)   (No DPMI)
  893.                                             -~   (No Novell)
  894.                                             -(   (Use slow memcopy 486 only)
  895.  
  896.         You   should  set  these  environment  variables  in   each   node's 
  897.         AUTOEXEC.BAT  which  requires them when using PKZIP  and\or  PKUNZIP 
  898.         with PCBFV. These variables will NOT function properly if set in the 
  899.         PCBVIEW.BAT file that calls PCBFV.EXE.
  900.  
  901.         Examples:
  902.           SET FVZIP=-+  would turn off EMS use in PKZIP when Flagging files.
  903.           SET FVZIP=--+ same as above, plus XMS is turned off.
  904.           SET FVUNZIP=-) turns off DPMI use in PKUNZIP when Reading files.
  905.  
  906.         NOTE:   The FVUNZIP environment variable is not needed if  the  same 
  907.         functions  are permanently turned off with the  PKUNZIP  environment 
  908.         variable as outlined in the PKZIP 2.04e manual addendum.
  909.    
  910.         NOTE:  The  FVZIP  environment variable is not needed  if  the  same 
  911.         functions  are  being  permanently turned  off  with  the  PKZIP.CFG 
  912.         configuration file as outlined in the PKZIP 2.04e manual.
  913.  
  914.         NOTE:  Only the characters in the chart above may be used  in  these  
  915.         two  PCBFV  environment variables.  PCBFV will not use  ANY  of  the 
  916.         variable's contents if other switches are attempted.
  917.  
  918.         NOTE:  The  use  of these environment variables in no  way   affects  
  919.         the amount of memory PCBFV will test for with each function.
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.         --------------------------------------------------------------------
  928.         Page 15                        PCBFV                         Page 15
  929.         --------------------------------------------------------------------
  930.  
  931.         2.10  Sample configurations
  932.         ---------------------------
  933.  
  934.         [Single node]
  935.         -------------
  936.           
  937.         C:\PCB
  938.         ------
  939.           PCBVIEW.BAT - contains  PCBFV.EXE  PCBFV.CNF  %1
  940.           PCBFV.EXE
  941.           PCBFV.CNF
  942.           FVHLP, FVMNU, & FVZRO
  943.  
  944.         You may prefer this alternate single node configuration
  945.                          
  946.         C:\PCBFV (or the location of your choice)
  947.         --------
  948.           PCBFV.EXE
  949.           PCBFV.CNF
  950.           FVHLP, FVMNU, & FVZRO
  951.         C:\PCB  
  952.         ------
  953.           PCBVIEW.BAT - contains  C:\PCBFV\PCBFV.EXE  PCBFV.CNF  %1
  954.           
  955.         [*MULTI-NODE*] 
  956.         -------------------------------------------------------------
  957.         [Example 1 (using a single PCBFV.CNF file)]
  958.  
  959.         Your multi-node PCBFV.CNF would look something like this:
  960.  
  961.         Idle keyboard time-out (minutes) : 3
  962.         Maximum extracted file size      : 600000
  963.         Work location of extracted file  : C:\WORK@NODE@\
  964.         Path to compression utilities    : C:\UTILS\
  965.         Swap PCBFV if needed (Y,D,N)     : N
  966.         Follow eXpert mode in USERS      : N
  967.         Disable (R)ead text option       : N
  968.         Security needed to (R)ead files  : 0
  969.         Maximum lines to (R)ead per file : 0
  970.         Default wildcard (R)ead answer   : NONE
  971.         Y/n/a prompt for wildcard find   : (H)elp, Read this file?
  972.         Disable (S)elect file option     : N
  973.         # files in each (F)lagged file   : 10
  974.         Security needed to (F)lag files  : 0
  975.         Loc\Name of new (F)lagged file   : C:\UPLOAD\FLAG@NODE@.ZIP
  976.         Disable (F)lagging across files  : N
  977.         Disable AutoFlag on PCB return   : N
  978.         Non-Text file type for HEX mode  : E
  979.         Your PCBFV registration number   : 0
  980.         Main prompt : (H)elp, File View Command?
  981.  
  982.  
  983.         ONLY edit PCBFV.CNF files with the enclosed FVSETUP utility.
  984.  
  985.                        Section 2.10 continues on the next page
  986.    
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.         --------------------------------------------------------------------
  994.         Page 16                        PCBFV                         Page 16
  995.         --------------------------------------------------------------------
  996.  
  997.         2.10  Sample configurations (continued)
  998.         ---------------------------------------
  999.         If you cannot use the single file PCBFV.CNF method you will need  to 
  1000.         make  a  configuration file for each node and  place  the  different  
  1001.         configuration file name in each node's PCBVIEW.BAT.  
  1002.         
  1003.         [Sample - node 1 (using separate PCBFVx.CNF files)]
  1004.  
  1005.         Idle keyboard time-out (minutes) : 3
  1006.         Maximum extracted file size      : 600000
  1007.         Work location of extracted file  : C:\WORK1\
  1008.         Path to compression utilities    : C:\UTILS\
  1009.         Swap PCBFV if needed (Y,D,N)     : N
  1010.         Follow eXpert mode in USERS      : N
  1011.         Disable (R)ead text option       : N
  1012.         Security needed to (R)ead files  : 0
  1013.         Maximum lines to (R)ead per file : 0
  1014.         Default wildcard (R)ead answer   : NONE
  1015.         Y/n/a prompt for wildcard find   : (H)elp, Read this file?
  1016.         Disable (S)elect file option     : N
  1017.         # files in each (F)lagged file   : 10
  1018.         Security needed to (F)lag files  : 0
  1019.         Loc\Name of new (F)lagged files  : C:\UPLOAD\FLAG1.ZIP
  1020.         Disable (F)lagging across files  : N
  1021.         Disable AutoFlag on PCB return   : N
  1022.         Non-Text file type for HEX mode  : E
  1023.         Your PCBFV registration number   : 0
  1024.         Main prompt : (H)elp, File View Command?
  1025.  
  1026.         [Sample - node 2 (using separate PCBFVx.CNF files)]
  1027.           
  1028.         Idle keyboard time-out (minutes) : 3
  1029.         Maximum extracted file size      : 600000
  1030.         Work location of extracted file  : C:\WORK2\
  1031.         Path to compression utilities    : C:\UTILS\
  1032.         Swap PCBFV if needed (Y,D,N)     : N
  1033.         Follow eXpert mode in USERS      : N
  1034.         Disable (R)ead text option       : N
  1035.         Security needed to (R)ead files  : 0
  1036.         Maximum lines to (R)ead per file : 0
  1037.         Default wildcard (R)ead answer   : NONE
  1038.         Y/n/a prompt for wildcard find   : (H)elp, Read this file?
  1039.         Disable (S)elect file option     : N
  1040.         # files in each (F)lagged file   : 10
  1041.         Security needed to (F)lag files  : 0
  1042.         Loc\Name of new (F)lagged file   : C:\UPLOAD\FLAG2.ZIP
  1043.         Disable (F)lagging across files  : N
  1044.         Disable AutoFlag on PCB return   : N
  1045.         Non-Text file type for HEX mode  : E
  1046.         Your PCBFV registration number   : 0
  1047.         Main prompt : (H)elp, File View Command?
  1048.  
  1049.         ONLY edit PCBFV.CNF files with the enclosed FVSETUP utility.
  1050.  
  1051.         As demonstrated, PCBFV is very flexible in how it may be  installed. 
  1052.         It can be installed in all configurations of PCBoard.
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.         --------------------------------------------------------------------
  1060.         Page 17                        PCBFV                         Page 17
  1061.         --------------------------------------------------------------------
  1062.  
  1063.         3.0  Installing PCBFV in PCBFiler
  1064.         ---------------------------------
  1065.         Enclosed  with  PCBFV version 3.3 is a new utility, FVMM,  which  is
  1066.         designed to bring many capabilities to PCBFiler's ALT-V process that 
  1067.         have not been available before.  Review FVMM.DOC.  If you decide you 
  1068.         do not want to install FVMM in PCBFiler, the instructions below will 
  1069.         assist you in installing PCBFV in PCBFiler instead.
  1070.  
  1071.         A /L parameter is used (see below) which instructs PCBFV to  operate 
  1072.         in a "true" local mode.  All "on-line" functions are disabled,  such 
  1073.         as  keyboard  time-out,  caller status line at  the  bottom  of  the 
  1074.         screen,  etc.  The local monitor type is automatically detected  and 
  1075.         color is used if appropriate. 
  1076.  
  1077.         Special  Note:   If  you are installing PCBFV in  PCBFiler  and  are 
  1078.         using PCBFV.CNF files with the @NODE@ macro in the "work location of 
  1079.         extracted  file"  parameter in FVSETUP, you must  create  a  special 
  1080.         configuration file for use in the  /L mode which fully specifies the 
  1081.         "work  location".  You may call this file FILER.CNF and  install  it 
  1082.         with PCBFV into PCBFiler as shown below.
  1083.  
  1084.         At  PCBFiler's first screen select "Edit PCBFILER defaults page  2". 
  1085.         At the bottom of this screen, enter parameters as follow:
  1086.  
  1087.         File VIEWERS - filename extensions and commands for executing viewer
  1088.         File Extension : ZIP      DOS Command : c:\pcb\PCBFV FILER.CNF /L
  1089.         File Extension : ARJ      DOS Command : c:\pcb\PCBFV FILER.CNF /L
  1090.         File Extension : GIF      DOS Command : c:\pcb\PCBFV FILER.CNF /L
  1091.  
  1092.         For each compression type (which PCBFV is compatible with) place the 
  1093.         "DOS  Command :" entry as above.  The parameters must be  placed  in 
  1094.         the same order as they are shown in the examples:
  1095.  
  1096.         Name\location of PCBFV.EXE, configuration file, then /L.
  1097.  
  1098.         The  (S)elect  command and all function keys are  disabled  in  this 
  1099.         mode.  All other sections in this documentation apply to  installing 
  1100.         PCBFV in PCBFiler.
  1101.  
  1102.         3.1  Installing PCBFV as a local utility
  1103.         ----------------------------------------
  1104.         Create a batch file called FV.BAT (or whatever name you choose): 
  1105.           
  1106.         C:\PCB\PCBFV  PCBFV.CNF  /L  %1
  1107.  
  1108.         Place  FV.BAT  (or whatever you name it) in your DOS path,  and  you 
  1109.         have  a  full powered viewer, extractor at your  fingertips  at  all 
  1110.         times by typing FV FILENAME.ZIP (an extension IS  required  in  this 
  1111.         mode). All other areas of this manual apply to this installation.
  1112.  
  1113.         Special Note: If you are installing PCBFV as a local utility and are 
  1114.         using  PCBFV.CNF  files with the @NODE@ macro in "work  location  of 
  1115.         extracted file, you must create a special configuration file for use 
  1116.         in  the  /L mode which fully specifies the  "work location".  It  is 
  1117.         recommended  that this file be called LOCAL.CNF and  installed  with 
  1118.         PCBFV into FV.BAT instead of PCBFV.CNF as shown above.
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.         --------------------------------------------------------------------
  1126.         Page 18                        PCBFV                         Page 18
  1127.         --------------------------------------------------------------------
  1128.  
  1129.         3.2  Installing PCBFV as a door
  1130.         -------------------------------
  1131.         This  capability exists in case Sysops have a need to diversify  the 
  1132.         utilization of PCBFV's many features, or in case there is a  limited 
  1133.         memory situation and PCBoard and PCBFV cannot be allowed to swap.
  1134.           
  1135.         We  have  heard from many Sysops saying they installed  PCBFV  as  a 
  1136.         private  door  for themselves and\or their Co-Sysops,  free  of  the 
  1137.         limitations  they  wanted PCBFV to impose on regular  callers  while 
  1138.         using the F V process.
  1139.  
  1140.         The documentation for installing PCBFV as a door is almost the  same 
  1141.         as  installing it in the F V shell.  For door  installation,  simply 
  1142.         follow the instructions below INSTEAD of those found in section 2.1.
  1143.         All other sections apply to door installation.
  1144.  
  1145.         Install a door called FV in DOOR.LST file with PCBSETUP. Place  this 
  1146.         entry  at the  end  of DOOR.LST, as the recommended usage calls  for  
  1147.         invoking PCBFV  as a door by name (FV), rather than the conventional 
  1148.         way of placing it in your door menu and calling it by number. Answer 
  1149.         NO to the USERS.SYS and DOOR.SYS parameters. If using PCBoard 14.5a, 
  1150.         it  is  up to the Sysop to decide on whether to install PCBFV  as  a 
  1151.         "shell to" door or not.
  1152.                               
  1153.         Create a door (batch) file called FV :
  1154.  
  1155.         @echo off
  1156.         M:\PCBFV\PCBFV.EXE PCBFV.CNF C:\PCB /DOOR
  1157.         board              --------- ------ -----
  1158.                            |         |      |_ Put PCBFV into door mode 
  1159.                            |         |                           
  1160.                            |         |__Location of THIS node's PCB root
  1161.                            |                                          
  1162.                            |__ PCBFV configuration file. 
  1163.  
  1164.         Notice that we didn't change drive and/or cd\ to the PCBFV location. 
  1165.         Instead,  we  called  it directly from where FV is  run  because  of 
  1166.         PCBFV's ability to do this.  This results in faster load  time.  If, 
  1167.         however, you are running *MULTI-NODES* and each node is residing  on 
  1168.         a different drive, you may find it faster to install PCBFV as a door 
  1169.         on each node's drive. 
  1170.  
  1171.         Make sure your PCBoard menus reflect the FV command instead of F V. 
  1172.  
  1173.         PCBFV (as a door) can be passed a filename from the PCBoard  command 
  1174.         prompt,  the  same  way the F V shell process  passes  a  file,  for 
  1175.         example  "FV TEST.ZIP".  This requires no extra installation by  the 
  1176.         Sysop and is handled automatically by PCBoard and PCBFV.
  1177.  
  1178.         PCBFV's door mode works with PCBoard 14.5a's "shell to" door mode.
  1179.           
  1180.         If  running PCBFV as a "shell to" door in PCBoard 14.5a, do NOT  end 
  1181.         the door file with the "board" command as shown above.
  1182.           
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.         --------------------------------------------------------------------
  1192.         Page 19                        PCBFV                         Page 19
  1193.         --------------------------------------------------------------------
  1194.  
  1195.         4.0  Notes regarding the (R)ead command
  1196.         -----------------------------------------
  1197.         In previous versions of PCBFV, only text files could be displayed to 
  1198.         the caller.  With the addition of the HEX mode display in PCBFV 2.2, 
  1199.         the caller may read any type of file, depending on how the Sysop has 
  1200.         enabled the HEX mode display feature. Typically, files which contain 
  1201.         carriage-return and\or line-feed sequences will  be regarded as text  
  1202.         files  by PCBFV. All other files will have to meet the criteria  the  
  1203.         Sysop has set for the HEX display feature (see section 2.4 page 11).
  1204.  
  1205.         The (F)ind Text command available while reading text files is a full 
  1206.         featured  search mechanism.  The whole page surrounding the text  is 
  1207.         displayed with the found text highlighted in the center line of  the 
  1208.         screen. The "maximum number of lines to display" setting is honored, 
  1209.         callers  cannot (F)ind past the number of lines the Sysop  may  have 
  1210.         set for this parameter.
  1211.  
  1212.         The (F)ind command is complimented by a (R)epeat Find, which repeats 
  1213.         the  last Find command performed on the current text.  The  "maximum 
  1214.         number  of  lines  to display" setting is  honored,  callers  cannot 
  1215.         (R)epeat  past the number of lines the Sysop may have set  for  this 
  1216.         parameter. 
  1217.  
  1218.         The text reading (and searching) process is further enhanced by  the 
  1219.         following commands which allow easy reading of text files:
  1220.  
  1221.         (T)op of  file command which allows the caller to quickly return  to 
  1222.         the beginning of the file being read.
  1223.  
  1224.         (P)ageUp allows the previous page of text to be displayed.   
  1225.  
  1226.         (<) and (>) scroll the screen left and right for viewing long  lines 
  1227.         of text (longer than 79 characters) on the screen.
  1228.           
  1229.         The (F)ind, (R)epeat, (P)ageUp. (<), (>), and (T)op commands  appear 
  1230.         in the "More" prompt at the end of a full page of text. The (R)epeat 
  1231.         command only appears after a (F)ind has been executed.
  1232.  
  1233.         When using PCBFV in local mode, the Sysop may use the  corresponding 
  1234.         cursor  movement keys: Home=(T)op  PgUp=(P)ageUp  PgDn=[Enter],  and 
  1235.         the left and right arrows = (<) and (>).
  1236.                                                        
  1237.         The (F)ind command is PCBFV's only limited function in  unregistered 
  1238.         copies.  The (F)ind command IS functional in unregistered copies  of 
  1239.         PCBFV,  but only when the Sysop (the name in record #1 of  the USERS 
  1240.         file)  is  the person on-line, or when PCBFV is being  used  in  any 
  1241.         local mode. 
  1242.  
  1243.         PCBFV will read DOS and non-DOS text files.  Non-DOS text files  are 
  1244.         text  files which contain line-feeds only, as opposed to  DOS  files 
  1245.         which contain carriage-returns and line-feeds.
  1246.  
  1247.         PCBFV tests text files for characters such as ANSI escape  sequences 
  1248.         and  form feeds.  If either are found PCBFV suppresses  them  before 
  1249.         displaying the text.
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.         --------------------------------------------------------------------
  1258.         Page 20                        PCBFV                         Page 20
  1259.         --------------------------------------------------------------------
  1260.  
  1261.         4.1  Notes regarding the (S)elect command
  1262.         -----------------------------------------
  1263.         PCBFV's (S)elect command is completely conference DLPATH.LST  aware. 
  1264.         The  caller  will only be able to (S)elect files to view  which  are 
  1265.         available to the conference they are in (or last in, if using  PCBFV 
  1266.         as a door).  PCBFV's (S)elect command is also completely FSEC aware. 
  1267.         When  a  (S)elect request is found, PCBFV checks FSEC to insure  the 
  1268.         caller  has  security  to view the file.  If the  file  is  password 
  1269.         protected, PCBFV will also ask the caller the password, and performs 
  1270.         this operation in the same manner as PCBoard. 
  1271.  
  1272.         PCBFV  uses  the "Filename  EXTENSION for compressed files" entry in 
  1273.         PCBSETUP as  the default filename extension when performing its  own 
  1274.         file searches. 
  1275.  
  1276.         PCBFV's  (S)elect  command  is compatible with the  new  file  index 
  1277.         system introduced in PCBoard version 14.5a.
  1278.                     
  1279.  
  1280.         4.2  Notes regarding the (F)lag command
  1281.         ---------------------------------------
  1282.         The System Administrator/Operator may specify the  type of files the 
  1283.         caller may flag (see section 2.6 FLAG.DAT). A security level may  be 
  1284.         attached  to  this command.  Callers may  "flag  across files"  (see 
  1285.         section  4.4  below).  There  is an  (I)nventory  command,  and  the 
  1286.         inventory information file is automatically included in each  caller 
  1287.         created file. 
  1288.  
  1289.         Files which are (F)lagged for individual download are  automatically 
  1290.         placed in the compressed file designated for the node the caller  is 
  1291.         on.  The extracted member is then deleted from the  work  directory. 
  1292.         This  keeps  the amount of disk space PCBFV is  requiring  down  and 
  1293.         allows  a  RAM drive to be used as a work  location,  which  greatly 
  1294.         speeds up overall execution of the F V function.
  1295.  
  1296.         Regardless of how PCBFV is installed, the caller will never be  able 
  1297.         to include ALL of the files from a compressed file into their caller 
  1298.         created  file.  In  all cases, the caller at best will  be  able  to 
  1299.         include  all but ONE file into their flagged file.  For instance, if 
  1300.         you set PCBFV to allow 5 files for inclusion into the caller created
  1301.         file, and the caller is viewing a compressed file with 4 files,  the 
  1302.         most  they will be able to flag of those is 3 of the 4.  The  theory 
  1303.         behind  this is the caller should download  the  actual file  rather 
  1304.         than flagging each individual file.
  1305.                               
  1306.         A caller cannot (F)lag a file if they don't have enough daily  bytes 
  1307.         to download it in PCBoard. This prevents them from going through the 
  1308.         motions of Flagging, then returning to PCBoard only to discover they 
  1309.         cannot download it anyway.  Files which are FREE/NOTIME  are  EXEMPT 
  1310.         from this (F)lag limitation. PCBFV uses the "daily bytes downloaded" 
  1311.         as last updated in the USERS file, and the amount of bytes available 
  1312.         as installed in FSEC, for this purpose.  To bypass this byte  check, 
  1313.         add /NOBYTE to the end of the PCBFV command line.
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.         --------------------------------------------------------------------
  1324.         Page 21                        PCBFV                         Page 21
  1325.         --------------------------------------------------------------------
  1326.  
  1327.         4.3  Notes regarding the AutoFlag feature
  1328.         -----------------------------------------
  1329.         If  allowed,  PCBFV will make PCBoard think the caller  has  entered 
  1330.         instructions  to "FLAG" the caller created flagged file as  part  of 
  1331.         PCBoard's  own "FLAG" list.  PCBoard will remind  the caller of  the 
  1332.         existence  of their "flagged" file in the "batch"  when the   caller  
  1333.         enters "D" from PCBoard, logs off  without  downloading their  batch 
  1334.         list, etc.  
  1335.  
  1336.         How  it works: For the purposes of this example, we'll say the  name 
  1337.         of  the caller created file in PCBFV is called  FLAGGED.ZIP.   PCBFV 
  1338.         uses PCBoard 14.5a's  PCBSTUFF.KBD file feature to tell  PCBoard  to 
  1339.         enter FLAG FLAGGED.ZIP at the PCBoard prompt after a F V session.
  1340.  
  1341.         Operational notes: If "flagging across files" and AutoFlag are  both 
  1342.         enabled  and  it is the first F V session, AutoFlag will  occur.  On 
  1343.         subsequent  F  V sessions, if the caller Flags (in  PCBFV)  separate 
  1344.         files, they  will  be asked if they've  downloaded  FLAGGED.ZIP  yet 
  1345.         (since/if  you  allow  flagging across files, PCBFV has  no  way  of 
  1346.         knowing).  If they answer Yes, PCBFV will AutoFlag again at the  end 
  1347.         of  the current F V session. If they answer No, PCBFV won't  perform 
  1348.         AutoFlag. If the caller answers No, and they really have  downloaded 
  1349.         FLAGGED.ZIP, then AutoFlag won't occur (since they answered No)  and 
  1350.         the file will not be placed in PCBoard's FLAG list. Subsequently, if 
  1351.         the caller answers Yes they downloaded FLAGGED.ZIP but really didn't
  1352.         PCBFV will AutoFlag the caller created (FLAGGED.ZIP) file. Since the 
  1353.         the caller really didn't download  (in this scenario) it will  still 
  1354.         exist in PCBoard's FLAG batch list, and the caller will receive:
  1355.  
  1356.         (@OPTEXT@) duplicates a file already in the batch!
  1357.  
  1358.         This is record #554 in PCBTEXT. Changing it to something like:
  1359.  
  1360.         (@OPTEXT@) exists in the batch list...
  1361.  
  1362.         is recommended as it sounds less like an error message, and is still 
  1363.         informative  if the caller DBs or FLAGs  a duplicate d/l  file  from 
  1364.         PCBoard.  The  @optext@ in the above examples is replaced  with  the 
  1365.         appropriate caller created flagged file name (FLAGGED.ZIP, etc.).
  1366.  
  1367.         The  download path(s) which contain your FLAGGED.ZIP  (or  FLAG1.ZIP 
  1368.         FLAG2.ZIP  etc.) should be placed at the beginning of DLPATH.LST  so 
  1369.         PCBoard's  FLAG search occurs as quickly as possible when  returning 
  1370.         from the F V shell. Do not place this path in PCBoard 14.5a's INDEX.
  1371.  
  1372.         The  Auto-Flag  feature,  introduced  in PCBFV  2.1,  is  no  longer 
  1373.         compatible  with  PCBoard 14.5.  Auto-Flag now  works  with  PCBoard 
  1374.         14.5a only.
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.         --------------------------------------------------------------------
  1390.         Page 22                        PCBFV                         Page 22
  1391.         --------------------------------------------------------------------
  1392.  
  1393.         4.4  Notes regarding "flagging across files"
  1394.         --------------------------------------------
  1395.         If you allow the caller to "flag across files", this means they will 
  1396.         be  able to view a compressed file, select files from it to download 
  1397.         individually,   then  view  another  compressed  file   and   select 
  1398.         individual files from it, adding all of the individual files to  one 
  1399.         caller created file for downloading.
  1400.  
  1401.         The  number which you place in the "# files in each (F)lagged  file" 
  1402.         parameter  in  FVSETUP will be observed, even when  flagging  across 
  1403.         files is allowed.  If a caller should select an individual  filename 
  1404.         which  is  identical in two different compressed files,  the  caller 
  1405.         will be given the choice of which one to keep in the "caller created 
  1406.         compressed file", as obviously a compressed file cannot contain  two 
  1407.         files with the same name. 
  1408.  
  1409.         For systems that enforce download file counts, you need to be  aware 
  1410.         that if you allow "flagging across files" and you also place a  high 
  1411.         number  in  the  "# of files in each (F)lagged  file"  parameter  in 
  1412.         FVSETUP,  unscrupulous callers might be able to use it to "beat  the 
  1413.         system".  In most cases, placing a low number in the  FVSETUP  field 
  1414.         "#  of files in each (F)lagged file" will prevent  this  undesirable 
  1415.         effect. Also, using FLAG.DAT (see section 2.6) to limit the types of 
  1416.         names of files that can be flagged, in conjunction with a low number 
  1417.         allowed  in  each  caller  created file,  will  surely  thwart  this 
  1418.         activity.  In  all  cases, disabling "flagging  across  files"  will 
  1419.         eliminate the need for concern completely.
  1420.  
  1421.         
  1422.         4.5  Notes regarding the (I)nventory command
  1423.         --------------------------------------------
  1424.         This  command allows the caller to take inventory of  their  current 
  1425.         "Flag file". They will be shown the contents which will consist of a 
  1426.         list of the individual files they have flagged, the compressed  file 
  1427.         name which the individual files came from, and the size in bytes  of 
  1428.         the  "Flag  file"  they  have  created.  The  file  containing   the 
  1429.         information  shown  by the (I) command is created by PCBFV  in  each 
  1430.         node's  work  directory  you have assigned it.  This  file  is  also 
  1431.         automatically included in the "Flag file" the caller will  download, 
  1432.         so  that  the caller will have a reference as  to  which  individual 
  1433.         files came from which compressed files.  The (I)nventory command  is 
  1434.         disabled if the (F)lag command is disabled.
  1435.                                    
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.         --------------------------------------------------------------------
  1456.         Page 23                        PCBFV                         Page 23
  1457.         --------------------------------------------------------------------
  1458.  
  1459.         4.6  Notes regarding compression utilities
  1460.         ------------------------------------------
  1461.         The  compression utilities required by PCBFV depend on the types  of 
  1462.         compressed  files carried on your system.  Below is a summary of the 
  1463.         required files for each compression type, and any limitations  PCBFV 
  1464.         imposes on them.
  1465.  
  1466.         All compression utilities must reside in the location specified  for 
  1467.         "Location of Compression Utilities" in PCBFV.CNF using FVSETUP.EXE.
  1468.                                         
  1469.         (SFX = Self-Extracting)
  1470.                                              
  1471.         * ZIP and ZIP SFX (.EXE) files 
  1472.         ------------------------------
  1473.         PKUNZIP.EXE  version 2.04e is required for reading and flagging from 
  1474.         ZIP files.  If flagging is allowed and the caller created file is  a
  1475.         ZIP file (FLAG.ZIP etc.) then PKZIP.EXE version 2.04e is required. 
  1476.                     
  1477.         * LZH and LZH SFX (.EXE & .COM) files 
  1478.         -------------------------------------
  1479.         LHA.EXE  version 2.12 is required for reading and flagging from  LZH 
  1480.         files.  The  same file is required if flagging is  allowed  and  the 
  1481.         caller created file is a LZH file (FLAG.LZH etc.). 
  1482.  
  1483.         * ARJ and ARJ SFX (.EXE) files
  1484.         ------------------------------
  1485.         ARJ.EXE  version 2.30 is required for reading and flagging from  ARJ 
  1486.         files.  Because ARJ SFX files did not contain an ARJ signature prior 
  1487.         to ARJ version 2.20, PCBFV will only perform operations on SFX  type 
  1488.         ARJ  files created with ARJ version 2.20 and later.  ARJ.EXE is also  
  1489.         required  if flagging is allowed and the caller created file  is  an  
  1490.         ARJ file (FLAG.ARJ etc.).  Sysops using ARJ as a flag file should be  
  1491.         aware that a large amount of memory is required to create ARJ files.
  1492.  
  1493.         * PAK files 
  1494.         -----------
  1495.         PAK.EXE  version 2.10 is required for reading and flagging from  PAK 
  1496.         files.  The  same file is required if flagging is  allowed  and  the 
  1497.         caller created file is a PAK file (FLAG.PAK etc.).  PAK version 2.10 
  1498.         is not the newest version of PAK. Versions of PAK after 2.10 require 
  1499.         far too much memory to use with PCBFV.  This older version of PAK is 
  1500.         available on the YCS support system if needed. SFX PAK files are not
  1501.         supported by PCBFV.
  1502.                                              
  1503.         * ARC files
  1504.         -----------
  1505.         PKUNPAK.EXE  version 3.61 is required for reading and flagging  from 
  1506.         ARC files. If flagging is allowed and the caller created file is  an 
  1507.         ARC  file (FLAG.ARC etc.) then PKPAK.EXE version 3.61  is  required. 
  1508.         SFX ARC files are not supported by PCBFV.
  1509.  
  1510.         * SDN files
  1511.         -----------
  1512.         SDN  (Shareware Distribution Network) files are PAK files  with  the 
  1513.         .SDN extension.  See "PAK files" above for details.
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.         --------------------------------------------------------------------
  1522.         Page 24                        PCBFV                         Page 24
  1523.         --------------------------------------------------------------------
  1524.  
  1525.         4.7  Notes regarding the (D)elete command
  1526.         -----------------------------------------
  1527.         The (D) command allows the local Sysop to delete unwanted files from 
  1528.         ZIP files (only), such as BBS advertisements, COMMAND.COM, etc. This 
  1529.         command  can only be used if PCBFV has been started with /L  on  the 
  1530.         PCBFV command line such as in PCBFiler, FVMM, or local utility mode. 
  1531.         This command is completely disabled whenever a caller is on remotely 
  1532.         including  the Sysop.  If (D) is entered while on-line,  it  is  not 
  1533.         accepted as input (in other words, the D cannot even be typed at the 
  1534.         PCBFV prompt). After selecting (D), the local Sysop will be prompted 
  1535.         for  a filename in the compressed file to delete.  PCBFV  will  then 
  1536.         re-display the filename and ask the local Sysop for confirmation.
  1537.  
  1538.         If  the  local Sysop enters a (D) command while viewing a  ZIP  file 
  1539.         which contains ANY files with -AV stamps, PCBFV will warn the  Sysop 
  1540.         that the ZIP *MIGHT* be an -AV file and will prompt the local  Sysop 
  1541.         on whether to continue or not.  Currently, PCBFV only checks for -AV
  1542.         markings in ZIP files made with PKZIP version 1.10, 2.04c and 2.04e.
  1543.         If a newer version of PKZIP becomes available and is used to  create 
  1544.         a  ZIP  and  the (D) command is used, PCBFV *MAY* warn  that  a  new 
  1545.         compression  type  has been detected and the -AV test could  not  be 
  1546.         performed.  See page 28 section 5.7 for additional details regarding 
  1547.         new utilities.
  1548.                             
  1549.         Other compression types (non ZIP) may contain "security  envelopes". 
  1550.         Future  versions of PCBFV may be given the ability to  detect  these 
  1551.         "envelopes", thereby allowing the (D) command to function with other 
  1552.         compression types in addition to ZIP files.
  1553.                   
  1554.         The  (D)elete command has the same memory and  external  compression 
  1555.         utility  requirements  as those listed for ZIP (F)lag requirements.
  1556.  
  1557.  
  1558.         4.8  Notes regarding the (Z)ip-Extra command
  1559.         --------------------------------------------
  1560.         PCBFV will display extra technical information about a ZIP file. 
  1561.  
  1562.         This extra information includes whether or not member files  contain 
  1563.         -AV  authenticity stamps, the version of PKZip used to compress  the 
  1564.         member  file,  whether each member file is text or binary,  and  the 
  1565.         host  operating system each file in the ZIP was compressed in  (DOS, 
  1566.         Amiga, Unix, etc.).
  1567.  
  1568.         NOTE: PCBFV does not check the validity of the -AV  stamps, it  only 
  1569.         displays which files contain them.
  1570.           
  1571.         NOTE:   Currently, PCBFV only checks for -AV markings in  ZIP  files 
  1572.         made with PKZIP versions 1.10, 2.04c and 2.04e.  If a newer  version 
  1573.         of  PKZIP  becomes available and is used to create  the  file  being 
  1574.         viewed  and the (Z) command is used,  the "ZIP -AV" column  will  be 
  1575.         blank or may contain incorrect information.  See section 5.7 on page 
  1576.         28 for more details regarding new compression utilities.
  1577.           
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.           
  1586.  
  1587.         --------------------------------------------------------------------
  1588.         Page 25                        PCBFV                         Page 25
  1589.         --------------------------------------------------------------------
  1590.  
  1591.         5.0  Sysop function keys
  1592.         ------------------------
  1593.         PCBFV follows F3 (printer on/off), F7 (alarm on/off) and F9 (display 
  1594.         on/off)  toggles  from PCBoard.  If F3 is on, PCBFV will  print  any 
  1595.         information sent to the caller log to the printer also. If F7 is on,
  1596.         PCBFV will beep locally (usually caller input errors). If F9 is off, 
  1597.         PCBFV  will turn the screen off.  Pressing any key locally turns the 
  1598.         screen on if F9 is active.  You may toggle these three function keys
  1599.         on  or off.  Their status will be displayed on the command  line  in 
  1600.         parenthesis (PAB).  Note: toggling an option on or off is  local  to 
  1601.         the PCBFV process only, since PCBoard does not read PCBOARD.SYS when 
  1602.         returning from a File View.  When PCBFV returns control to  PCBoard, 
  1603.         the toggles will be in the same state as before the File View shell. 
  1604.         Note:  the B displayed in (PAB) is the F4 page bell indicator.  This 
  1605.         is  shown on PCBFV's status line for information purposes  only  (if 
  1606.         page was allowed in PCBoard before the File View).
  1607.  
  1608.         5.1  Technical notes
  1609.         --------------------
  1610.         PCBFV  has  been designed to run specifically with  PCBoard versions
  1611.         14.5 and 14.5a.  PCBFV will not run with earlier versions of PCBoard 
  1612.         or with other brands of software.
  1613.  
  1614.         PCBFV  automatically  detects  PCBoard /M  multi-port  software  and 
  1615.         switches to FOSSIL communications mode for use with that version  of 
  1616.         PCBoard's communication driver.
  1617.  
  1618.         Carrier is monitored by PCBFV. Should a caller drop carrier while in
  1619.         PCBFV  they will be returned to PCBoard, which will detect  the  "no 
  1620.         carrier" status and cycle appropriately.
  1621.                   
  1622.         PCBFV works with non-standard com ports, addresses, and  IRQs.  COM1 
  1623.         is address 3F8/IRQ 4. COM2 is address 2F8/IRQ 3. If a COM port other 
  1624.         than 1 or 2 is used, PCBFV will use the address and IRQ as indicated
  1625.         in PCBOARD.DAT for the node.
  1626.  
  1627.         PCBFV checks for adequate disk space before attempting to extract  a 
  1628.         file for (R)eading or (F)lagging.
  1629.           
  1630.         If  a file name is stored with a directory location in a  compressed 
  1631.         file, that file cannot be (R)ead or (F)lagged by PCBFV.
  1632.  
  1633.         PCBFV follows the screen color and intensity as set in PCBSETUP  for 
  1634.         PCBoard (local screen). 
  1635.           
  1636.         If using PCBoard 14.5 (not 14.5a) /D or /S single node software  and 
  1637.         SHARE is loaded, it is impossible for PCBFV to  determine the user's
  1638.         security level.  Limiting the (R)ead and (F)lag functions  based  on 
  1639.         security is not possible.  The (S)elect command is also unavailable.
  1640.  
  1641.         All  of  the enclosed executable files have been compressed  with  a 
  1642.         commercial compression utility. Uncompressed versions of these files
  1643.         are not available.  
  1644.                                    
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.         --------------------------------------------------------------------
  1654.         Page 26                        PCBFV                         Page 26
  1655.         --------------------------------------------------------------------
  1656.            
  1657.         5.2  Caller log entries
  1658.         -----------------------
  1659.         PCBFV makes pertinent entries into the caller log as outlined below.
  1660.           
  1661.         If  the  (F)lag command is enabled,  PCBFV will make  the  following 
  1662.         entry in the caller log when a file is flagged:
  1663.         FILENAME.DOC in FILENAME.ZIP flagged for download
  1664.  
  1665.         PCBFV will make the following entries in the caller log to alert the 
  1666.         Sysop if inadequate disk space is encountered:
  1667.         Insufficient disk space to Read FILENAME.TXT
  1668.         Insufficient disk space to Flag FILENAME.TXT
  1669.  
  1670.         If  the (S)elect command is enabled, PCBFV will make the   following 
  1671.         entries in the caller log if the corresponding event occurs:
  1672.         View executed on file (FILENAME.ZIP)
  1673.         Error executing View of file (FILENAME.ZIP)
  1674.         (FILENAME.ZIP) not found!
  1675.         Insufficient security for Viewing (FILENAME.ZIP)
  1676.         Incorrect View Password for File (FILENAME.ZIP)
  1677.         (123456789.ZI) is an invalid filename!
  1678.           
  1679.         The caller log entries for the (S)elect command are identical to the 
  1680.         corresponding default entries in PCBoard's PCBTEXT.
  1681.  
  1682.         If  you do not wish for PCBFV to make these entries to  your  caller 
  1683.         log file(s), add /NOCALLER to the end of the PCBFV command  line  in 
  1684.         your PCBVIEW.BAT file(s).
  1685.  
  1686.  
  1687.         5.3  Error messages
  1688.         -------------------
  1689.         PCBFV  gives  verbose installation error messages, such  as  invalid 
  1690.         paths  and  file  names  you may have  placed  in  PCBFV.CNF.  These 
  1691.         messages appear and there is a short pause while they are displayed. 
  1692.         PCBoard   erases  the local screen after a F V shell and this  short 
  1693.         pause will allow you to see the message. 
  1694.  
  1695.         The following are explanations of PCBFV's run time error messages:
  1696.  
  1697.         * Error extracting file (1) * This means that the file selected  for 
  1698.         (R)eading  or  (F)lagging  already existed  in  the  work  directory 
  1699.         designated  for  this node. As a safety precaution, PCBFV  will  not 
  1700.         overwrite  a file which already exists in a work directory.  
  1701.                                         
  1702.         *  Error extracting file (2) *  This indicates the file  appears  in 
  1703.         the  compressed  file, but for some reason  the  extraction  utility 
  1704.         could not extract it.  This could possibly mean PCBFV was unable  to 
  1705.         find the extraction utility needed.  This could also indicate  there 
  1706.         was insufficient memory available for the extraction process.            
  1707.  
  1708.         *  bad command or filename * This is a DOS error message  indicating 
  1709.         that  PCBVIEW.BAT  could not find PCBFV.EXE,  or PCBFV.EXE could not 
  1710.         find the appropriate extraction utility.
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.         --------------------------------------------------------------------
  1720.         Page 27                        PCBFV                         Page 27
  1721.         --------------------------------------------------------------------
  1722.  
  1723.         5.4  Where to receive assistance
  1724.         --------------------------------
  1725.         Yandell  Computer  Services (YCS) provides the  following  technical 
  1726.         assistance for PCBFV:
  1727.           
  1728.         813-842-8099   The YCS Support System.  Available to all BBS Sysops.
  1729.                        INSTANT on-line credit card registration and  support
  1730.                        system for YCS Shareware.  On-line 7 days  per  week, 
  1731.                        24 hours per day.
  1732.  
  1733.  
  1734.         5.5  Disclaimer and warranty
  1735.         ----------------------------
  1736.         PCBFV is a shareware product.  PCBFV may be uploaded to BBS  systems 
  1737.         as long as copyright notices are not removed and no changes are made 
  1738.         to the program.  There are no warranties, expressed or implied,  for 
  1739.         unregistered  copies of PCBFV.  Sysops who install  PCBFV  on  their 
  1740.         systems assume any and all liabilities for anything which may result 
  1741.         as a consequence of running PCBFV.  For registered copies of  PCBFV, 
  1742.         Yandell  Computer  Services  warrants that  PCBFV  will  perform  as 
  1743.         described in this documentation.  In the event that PCBFV  does  not 
  1744.         perform  as specified, then Yandell Computer Services may  elect  to 
  1745.         fix  PCBFV or refund the amount paid, if notified within 30 days  of 
  1746.         registration. 
  1747.  
  1748.         Under no circumstances shall Yandell Computer Services or the author
  1749.         of  PCBFV  be liable for any loss of profit or  any  other  damages, 
  1750.         including but not limited to special, incidental, consequential,  or 
  1751.         other damages, arising out of the use or inability to use PCBFV.
  1752.  
  1753.  
  1754.         5.6  License to use PCBFV
  1755.         -------------------------
  1756.         PCBFV  is not "public domain" or "free" software.  A limited license
  1757.         is  granted to use and evaluate PCBFV for thirty days after  initial
  1758.         installation.  PCBFV  must  be registered if it is  used  after  the
  1759.         initial thirty day evaluation period.            
  1760.  
  1761.         A  PCBFV  registration may be used only on the  original  licensee's
  1762.         BBS system and only on nodes the original licensee owns and operates 
  1763.         for  their own purposes.  If the original licensee leases  or  sells 
  1764.         some  or  all  of their nodes to another entity,  those  nodes  will 
  1765.         require  their own PCBFV registration.  
  1766.  
  1767.         PCBFV registrations are not transferable. 
  1768.  
  1769.         A PCBFV registration is a license to use PCBFV software on  one  (1)
  1770.         BBS System at a single location with as many nodes as  the  original
  1771.         licensee owns and operates at THAT location.  When the licensee owns
  1772.         and operates other BBS' in other locations, each location requires a
  1773.         separate PCBFV registration.
  1774.  
  1775.         If  PCBFV  has not been registered after 30 days, a  Sysop  reminder
  1776.         will begin appearing at program termination and will also be written 
  1777.         to the current node's caller log file.
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.         --------------------------------------------------------------------
  1786.         Page 28                        PCBFV                         Page 28
  1787.         --------------------------------------------------------------------
  1788.  
  1789.         5.7  New compression utility releases
  1790.         -------------------------------------
  1791.         PCBFV generally does not become obsolete when a compression  utility 
  1792.         adds  a new compression method to their line-up.  If the author of a 
  1793.         particular  compression  utility adds a new compression  type,  they 
  1794.         usually  do  not change the "headers" in the compressed  file.  This 
  1795.         allows  utilities  such as PCBFV to view their contents  as  normal, 
  1796.         except  for  the "compression method", until PCBFV can  be  updated. 
  1797.         PCBFV will display "New\Unk" for the compression method if viewing a 
  1798.         file  which was created with a compression utility which contains  a 
  1799.         new  compression  type.  It  is recommended  that  new   compression 
  1800.         utilities (versions newer than those listed in section 4.6 page  23)
  1801.         NOT  be  used  for PCBFV's (R)ead,  (F)lag,  etc.  commands  without 
  1802.         checking  with Yandell Computer Services  first.  Newer  compression 
  1803.         utility  releases can and most likely will require more memory  than 
  1804.         their  predecessors,  and PCBFV may need to be updated to  test  for 
  1805.         the correct memory requirements.
  1806.  
  1807.         NOTE:  PKZIP -AV stamps have changed with each new release of  PKZIP 
  1808.         since being added to ZIP version 1.1.  Any PCBFV functions utilizing 
  1809.         -AV  information  such as (Z)ip-extra should be used  with  this  in 
  1810.         mind.  When  a  new PKZIP is released,  the  PCBFiler-mode  (D)elete 
  1811.         command should not be used until PCBFV can be updated to handle  new 
  1812.         -AV  stamps or until Yandell Computer Services announces no  updates 
  1813.         to PCBFV are needed.
  1814.  
  1815.                
  1816.  
  1817.         5.8  Revision history
  1818.         ---------------------
  1819.  
  1820.         Date       Version    Details
  1821.         --------   -------    -------
  1822.         07-19-90   1.0        PCBFV first released.
  1823.         08-02-90   1.1        Added wildcard (R)ead ability,  ability to use
  1824.                               one PCBFV.CNF file for multi-node systems,  at
  1825.                               the "More?" prompt the percentage of the  text
  1826.                               file that has been read is displayed.
  1827.         10-19-90   2.0        See the enclosed file FEATURES.NEW.
  1828.         11-21-90   2.1         "   "     "      "        "       
  1829.         02-22-91   2.2         "   "     "      "        "
  1830.         04-26-91   2.3         "   "     "      "        "
  1831.         07-19-91   2.4         "   "     "      "        "
  1832.         08-24-91   2.45        "   "     "      "        "
  1833.         12-20-91   2.5         "   "     "      "        "
  1834.         07-31-92   3.0         "   "     "      "        "
  1835.         11-27-92   3.1         "   "     "      "        "
  1836.         01-09-93   3.2         "   "     "      "        "
  1837.         01-29-93   3.3         "   "     "      "        "
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.         --------------------------------------------------------------------
  1852.         Page 29                        PCBFV                         Page 29
  1853.         --------------------------------------------------------------------
  1854.  
  1855.         6.0  Registering PCBFV
  1856.         ----------------------
  1857.         PCBFV is not free software. PCBFV should be registered no later than 
  1858.         30 days after installation. 
  1859.           
  1860.         Registration is $15.00 and may be paid by check, money order,  VISA, 
  1861.         Mastercard  or American Express.  If using a charge  card, you  will
  1862.         receive a registration number INSTANTLY!
  1863.           
  1864.         Refer to  the  enclosed file  ORDER.FRM  for  complete  registration 
  1865.         instructions.
  1866.  
  1867.  
  1868.         6.1  Register with CONFIDENCE - Author Information
  1869.         --------------------------------------------------
  1870.         L.  Brent  Yandell   has been programming  for  over  eleven  years, 
  1871.         including  more  than five years  of  developing  telecommunications 
  1872.         software. Many Sysops will be familiar with ChatBox, the popular on-
  1873.         line PCBoard chat door, and QReader, the `full-screen' text door.
  1874.  
  1875.         Yandell Computer Services (YCS) is a  licensed  business,  operating
  1876.         and existing under the laws of the State of Florida.
  1877.  
  1878.         Writing  BBS Shareware doors and utilities, in  addition  to  custom
  1879.         programming, is our business.... our ONLY business.
  1880.  
  1881.         First Door Release: 7/6/87 (USBBSDOR) - Still updated and supported!
  1882.  
  1883.         YCS  Shareware is GUARANTEED (each product's documentation  contains 
  1884.         each product's specific guarantee).
  1885.  
  1886.         Yandell  Computer  Services is an *AUTHORIZED*  merchant  for  VISA, 
  1887.         Mastercard and American Express charge cards.
  1888.  
  1889.         A dedicated multi-node BBS for support and on-line registrations,  a
  1890.         toll-free voice line for registrations, and a voice support line for
  1891.         registered customers are just a few of our offerings in our  efforts
  1892.         to provide you with FAST, FRIENDLY SERVICE.
  1893.  
  1894.  
  1895.  
  1896.